﻿AUDITORÍA DE CAMBIOS CHECK POINT - v1.1 - Persehus
===================================================================================================================

Responde a una pregunta: ¿qué se cambió en la base de gestión de Check Point entre dos fechas, quién lo cambió y
qué hay que replicar? No hace falta un backup de la fecha de inicio. Basta con indicar "desde cuándo".

Es un solo fichero, cambios_politica.sh. Corre en el Security Management Server, en modo Expert: recoge los datos
en solo lectura, genera el informe con el Python que trae Check Point y lo deja todo en un .tar.gz, con
informe.html e informe.txt dentro.

QUÉ ES "SOLO LECTURA"
-------------------------------------------------------------------------------------------------------------------

cambios_politica.sh abre una sesión read-only del Management API (mgmt_cli login read-only true). No publica, no
bloquea objetos, no instala política y no modifica la base de datos. Solo hace tres cosas:
  - lee show changes, las rulebases actuales, las fechas de los objetos y las sesiones abiertas;
  - exporta el audit log de gestión ($FWDIR/log/*.adtlog) con fwm logexport;
  - genera el informe y escribe un fichero en /var/log/ (usa /tmp mientras trabaja y lo limpia al terminar).

Carga en el equipo. Medida en un Security Management Server R81.20 de 2 CPU con unos 2.150 hosts, 640 redes y 6
capas Access, con un rango de dos meses: ocupa un núcleo durante la recogida, casi todo en la base de datos del
propio Management sirviendo las consultas de solo lectura (la misma carga que un administrador recorriendo objetos
y reglas en SmartConsole); la memoria no varía y no usa swap; las consultas van una detrás de otra, nunca en
paralelo. Tarda entre 5 y 15 minutos según el tamaño de la base y de si el API está recién arrancado; el rango de
fechas apenas influye. Durante la ejecución el equipo siguió atendiendo a SmartConsole y al API con normalidad.

POR QUÉ TRES FUENTES
-------------------------------------------------------------------------------------------------------------------

show changes (la base de las revisiones y del Change Report de SmartConsole) no ve varios tipos de cambio que sí
quedan en la base:
  - cambios hechos con dbedit / GuiDBedit, fuera de sesión;
  - cambios de System Data, como administradores;
  - sesiones de revisiones purgadas;
  - lo que deshizo un Revert to Revision;
  - en algunos casos, sesiones que el API no devuelve.

El script cruza show changes con el audit log, que es una fuente independiente, y con el estado de la propia base
(la fecha de creación y de última modificación de cada objeto y regla). Así también encuentra lo que se creó o
modificó en una sesión que no dejó rastro en las otras dos: sale en el apartado Sin registro, con su estado actual.
Puede deberse a una purga de revisiones posterior al cambio, a un audit log rotado o borrado, o a una sesión que
Check Point no registró. Avisa de todo lo que una sola fuente no explicaría.

Para mirar el estado de la base no usa una lista fija de tipos: recorre todas las listas y ajustes que el API de
tu versión sabe mostrar (las que anuncia el propio equipo con show commands más las de la referencia oficial de
las API 1.9 y 2.0: hosts, redes, servicios de todos los tipos, grupos, usuarios, servidores RADIUS/TACACS/SMTP,
comunidades VPN, perfiles, capas, Global Properties, ajustes avanzados de las blades, administradores, trusted
clients, API settings…), en el dominio y en System Data. comandos_base.txt, dentro del comprimido, deja constancia
de cada lista recorrida y de cuántos objetos devolvió. Si un cambio del audit log es de un tipo que la base no sabe
listar, el informe lo avisa en vez de callarlo.

REQUISITOS
-------------------------------------------------------------------------------------------------------------------

  - Acceso de administrador en modo Expert al Security Management Server, con el API de gestión activo (compruébalo
    con api status).
  - Que el audit log del equipo cubra el rango pedido. El script imprime desde qué fecha hay audit log disponible.
  - Nada en tu PC: el informe se abre con el navegador.
  - Para bajar el fichero con WinSCP, el usuario que conecta debe tener el shell /bin/bash (Check Point sk42178).

USO
-------------------------------------------------------------------------------------------------------------------

1. En el SMS (Expert), copia cambios_politica.sh (por ejemplo a /home/admin/) y ejecútalo:

     bash cambios_politica.sh 2026-10-01                                  # del 01/10 00:00 hasta ahora
     bash cambios_politica.sh 2026-10-01T08:00:00 2026-10-15T23:59:59     # rango exacto

Las fechas van en la hora local del equipo. Si solo se da la fecha, el script usa 00:00:00 para "desde" y 23:59:59
para "hasta".

Al final verás:

     Listo: /var/log/cambios_<equipo>_<fecha>.tar.gz   (md5 ...)

2. Baja ese .tar.gz a tu PC (WinSCP o scp) y descomprímelo. Dentro están informe.html e informe.txt. Abre el HTML
con doble clic en tu navegador.

Si el informe no se puede generar en el equipo, el script lo avisa y el comprimido sale igual, con los datos y el
generador (informe_cambios.py): en un PC con Python 3, en la carpeta descomprimida, ejecuta python
informe_cambios.py . informe.txt.

IMPORTANTE: El .tar.gz y los informes contienen la configuración de tu política: nombres, IPs y reglas. Trátalos
como información confidencial. El script no envía nada a ningún sitio.

CÓMO LEER EL INFORME
-------------------------------------------------------------------------------------------------------------------

  - Cabecera y AVISOS. Léelos primero. Indican cuántas sesiones hay y si en el rango hubo algo de esto:
    - un Revert to Revision;
    - una purga de revisiones;
    - cambios fuera de sesión (dbedit);
    - cambios de System Data;
    - sesiones que solo están en el audit log;
    - sesiones con cambios sin publicar.
  - Sección 1 — CAMBIO NETO = lo que hay que replicar. Para cada objeto o regla da el estado al inicio del rango y
    el estado final: NUEVO, MODIFICADO (campo: antes → después), BORRADO, o "creado y borrado / devuelto a su
    valor: nada que replicar".
    - El orden es: objetos primero (hay que crearlos antes de usarlos), luego reglas Access, NAT, Threat Prevention
      / HTTPS, y por último gateways.
    - Cada regla lleva su ubicación actual: capa, número, sección y las reglas vecinas.
    - Los cambios que solo están en el audit log salen marcados como tales.
  - Sección 2 — Detalle cronológico por sesión publicada: quién, cuándo y qué campos.
  - Sección 3 — Audit log, la segunda fuente, sesión a sesión. Las marcas <<< SOLO EN AUDIT LOG >>> y <<< DESHECHA
    por REVERT >>> dicen qué replicar y qué no.
  - Sección 4 (solo si hubo un revert) — Lo que deshizo el revert: esos cambios ya no están en la base.

La última línea dice si queda algo por revisar. Si todo cuadra, empieza por OK:; si hay sesiones que solo están en
el audit log, empieza por !!!.

Los números de regla son los de la base actual del equipo donde se ejecutó. Si replicas en otro SMS, ubica cada
regla por su nombre y sus vecinas.

LA VISTA HTML (INFORME.HTML)
-------------------------------------------------------------------------------------------------------------------

Es el mismo informe, más fácil de recorrer, con la marca de Persehus. Cada línea del .txt está en la página una
sola vez, igual y en el mismo orden; las marcas del texto (!!!, ===, # 1)…) se sustituyen a la vista por títulos, y
lo que la vista añade son recuentos, filtros y botones.

Se recorre por páginas, desde la barra lateral:

  - Resumen: en una frase, el rango y cuánto se tocó (objetos y reglas, sesiones, administradores); lo que hay que
    replicar (nuevos, modificados, borrados, sin efecto, y cuánto llevas replicado); quién hizo los cambios
    (sesiones por administrador); una gráfica de cambios en el tiempo con el revert marcado; los avisos que piden
    hacer algo, en lenguaje claro (Crítico si hubo un Revert to Revision o cambios sin registro; Atención si hubo
    cambios por dbedit, sesiones sin publicar o una purga); y a la derecha un calendario (pulsa un día para ver sus
    sesiones) y las sesiones del rango (pulsa una para abrirla).
  - Cambios: lo que hay que replicar, una fila por objeto o regla con su tipo, el cambio principal en una línea, la
    fecha y el estado. Al abrirla: dónde está (capa, número, sección y reglas vecinas), quién lo cambió, cuándo y
    en qué sesión, y una tabla Antes → Ahora con cada campo que cambió (en las listas, lo añadido y lo quitado). Lo
    creado muestra cómo quedó; lo borrado, lo que tenía. La búsqueda de esta página filtra la lista; la casilla
    "replicado" de cada fila se guarda solo en tu navegador, no en el fichero.
  - Historial: quién cambió qué y cuándo, sesión por sesión (las hechas fuera de sesión y las deshechas por un
    revert, marcadas).
  - Revert (si hubo uno): lo que deshizo y ya no está en la base.
  - Detalle técnico: lo que devuelven las revisiones de SmartConsole (show changes), para contrastar.

Al imprimir salen todas las páginas, sin la barra lateral.

Es un solo fichero y no se conecta a nada: no carga letras, scripts ni imágenes de internet, y su política de
seguridad (CSP) se lo impide al navegador. La tipografía (Geist, © 2023 Vercel, SIL Open Font License 1.1) va
dentro del propio fichero. El .txt sigue siendo la referencia.

LÍMITES CONOCIDOS (V1.1)
-------------------------------------------------------------------------------------------------------------------

  - Probado solo en Security Management Server R82 y R81.20. No probado en:
    - Standalone (gateway y gestión en el mismo equipo): usa el mismo API y el mismo audit log, pero no se ha
      medido;
    - Multi-Domain (MDS/CMA): el script no elige dominio;
    - Smart-1 Cloud;
    - R82.10 / R82.20;
    - versiones anteriores a R81.20.
  - Si el audit log del rango se rotó o se borró del equipo, lo que solo esté ahí no aparecerá. cambios_politica.sh
    imprime al final el fichero de audit log más antiguo del equipo ("audit log disponible en el equipo desde:
    ...") y el informe avisa si su primer registro es posterior a tu "desde". En la sección 4 también avisa si el
    audit log empieza después de la revisión destino de un revert.
  - Los objetos predefinidos que actualiza el propio Check Point (por ejemplo, las aplicaciones de App Control) no
    se listan: el informe solo dice cuántos hubo.
  - Purga de revisiones: el informe da la fecha de la purga. Si una sesión purgada tampoco quedó en el audit log,
    una regla o un objeto que ya existían y que esa sesión borró o movió antes de esa fecha no dejan rastro en
    ninguna fuente, y no se pueden precisar. Lo creado o modificado sí aparece, en Sin registro. Un objeto creado y
    borrado en sesiones sin registro tampoco se ve.
  - Tras un Revert to Revision, lo deshecho se saca del audit log, que puede no llegar tan atrás. Un revert que
    Check Point rechazó (el audit log lo registra como Failure, "Revert failed due to verification errors") no
    deshizo nada: el informe lo avisa y trata lo publicado después de esa revisión como cualquier otra sesión.
  - Tres ajustes no llevan fecha en la base (login-message, trusted-ca-settings e ips-update-schedule): si se
    cambiaron en una sesión sin registro, no hay forma de saberlo. Si un cambio del audit log es de un tipo que el
    API no sabe listar, el informe lo marca como "no comprobable" y muestra lo último registrado.

POLÍTICAS DE USO, LICENCIA Y GARANTÍA
-------------------------------------------------------------------------------------------------------------------

© 2026 STATEH NEX NETWORKS S.A.C. (Persehus). Todos los derechos reservados. Estos scripts y la vista HTML que
generan son propiedad intelectual de STATEH NEX NETWORKS S.A.C., que opera Persehus.

Al descargarlos o usarlos aceptas esta licencia. Se concede una licencia de uso gratuita, personal, no exclusiva
e intransferible: puedes ejecutarlos en tu trabajo, también en entornos de producción y en los servicios que
prestas a tus clientes, aunque cobres por esos servicios. Lo que no se cobra es el script.

No está permitido:
  - modificarlos ni crear versiones derivadas;
  - venderlos, alquilarlos o cobrar por ellos, integrarlos en otro producto o herramienta, ni comercializarlos de
    ninguna otra forma;
  - redistribuirlos ni publicarlos en otro sitio: la única descarga oficial es https://persehus.com;
  - quitar o cambiar esta nota, la cabecera de los ficheros ni las referencias a Persehus.

Cuando los uses o muestres sus resultados (informes, capturas, presentaciones), cita la fuente: Persehus ·
https://persehus.com.

Se entrega TAL CUAL, SIN GARANTÍA DE NINGÚN TIPO. Es una herramienta de solo lectura, pero tú decides dónde y
cuándo ejecutarla. Revisa el código antes de usarlo. En la medida en que la ley lo permita, STATEH NEX NETWORKS
S.A.C. (Persehus) no se hace responsable de su uso. Esta licencia se rige por las leyes del Perú.

Persehus · https://persehus.com
